Contexto global

AbrirFormulario

Variante de sintaxis: Por nombre

Sintaxis:

OpenForm(<NombreFormulario>, <Parámetros>, <Propietario>, <Único>, <Ventana>, <EnlaceNavegación>, <DescripciónNotificarCierre>, <ModoAperturaVentana>)

Parámetros:

Tipo: Cadena.
Nombre del formulario. Generado como una ruta completa al objeto de metadatos del formulario (por ejemplo, “Catalog.Counterparties.Form.ObjectForm” o “CommonForm.FileSaveForm”) o como una ruta completa a un objeto aplicado con el nombre de formulario predeterminado (por ejemplo, “Catalog.Goods.ChoiceForm”).
El método devuelve un formulario abierto sin importar cómo se especifique el nombre del formulario.
Nombres de formulario predeterminados:

• ObjectForm. Formulario de objeto predeterminado.
• FolderForm. Formulario de carpeta predeterminado.
• RecordForm. Formulario de registro de registro predeterminado.
• ListForm. Formulario de lista predeterminado.
• ChoiceForm. Formulario de selección predeterminado.
• FolderChoiceForm. Formulario de selección de carpeta predeterminado.
• ConstantsForm. Formulario de constante predeterminado.
• Form. Formulario de informe o procesador de datos predeterminado.
• SettingsForm. Formulario de configuración de informe predeterminado.
• LoadForm. Formulario para cargar configuraciones.
• SaveForm. Formulario para guardar configuraciones.
• VariantForm. Formulario para editar opciones de informe.
• ReportUserSettingsLoadForm. Formulario para cargar configuraciones de informe.
• ReportUserSettingsSaveForm. Formulario para guardar configuraciones de informe.
• ReportVariantsLoadForm. Formulario para cargar opciones de informe.
• ReportVariantsSaveForm. Formulario para guardar opciones de informe.
• FormDataSettingsLoadForm. Formulario para cargar configuraciones de datos de formulario.
• FormDataSettingsSaveForm. Formulario para guardar configuraciones de datos de formulario.
• SearchForm. Formulario de búsqueda de datos de texto completo.
• DataHistoryChangeHistoryForm. Formulario de historial de cambios que muestra una lista de versiones de datos. Para los parámetros, consulte Formulario del sistema para el historial de modificaciones de historial de datos.
• DataHistoryVersionDataForm. Formulario de datos de versión que muestra el informe “Datos de versión”. Para los parámetros, consulte Formulario del sistema para la versión de historial de datos.
• DataHistoryVersionDifferencesForm. Formulario con diferencias en versiones de historial de datos que muestra el informe “Diferencia entre versiones”. Para los parámetros, consulte Formulario del sistema para las diferencias de versión de historial de datos.

Para informes externos y procesadores de datos, especifique un nombre de formulario de la siguiente manera:

• ExternalReport.<nombre informe>.Form.<nombre formulario>
• ExternalReport.<nombre informe>.<nombre formulario estándar>
• ExternalDataProcessor.<nombre procesador datos>.Form.<nombre formulario>
• ExternalDataProcessor.<nombre procesador datos>.<nombre formulario estándar>

Un informe externo o procesador de datos debe estar registrado en la aplicación antes de llamar a este método. Para registrar un informe, use el método Connect. Para registrar un procesador de datos, use el método Connect. <Nombre informe> y <nombre procesador datos> son nombres del informe externo o procesador de datos.

Tipo: Estructura.
Los parámetros del formulario. La clave de la estructura es el nombre del parámetro y el valor es el valor del parámetro del formulario. El nombre del elemento debe coincidir con el nombre del parámetro de la estructura.

V = New Structure(“Clave”, Proveedor); Formulario = ObtenerFormulario(“Catalog.Contratistas.ObjectForm”, V); Formulario.Abrir();

El propietario del formulario es un formulario o un control de otro formulario.

Tipo: Arbitrario.
Este parámetro se puede utilizar para establecer una clave con un valor que se utilizará para buscar formularios que ya se hayan abierto. Si un formulario tiene la misma clave de unicidad, se activará el formulario encontrado en lugar de abrir un nuevo formulario.
Si el valor es Falso, el sistema buscará un formulario con una clave de unicidad predeterminada, y si el valor es Verdadero, no se buscará un formulario. Cualquier otro valor especifica la clave de unicidad en la que se realizará la búsqueda.
Valor predeterminado: Falso.

Tipo: .
La ventana de la aplicación en la que se abre el formulario.
Aplicable solo para un formulario de aplicación cliente. Solo se puede establecer una ventana de aplicación principal o una ventana de formulario auxiliar como ventana.
Aplicable solo para aplicaciones.

Tipo: Cadena, Indefinido.
Si contiene un valor diferente de Indefinido, entonces la propiedad URL se establece en este valor para el formulario obtenido como resultado de la llamada al método dado y la propiedad AutoURL de este formulario se establece en Falso.
Valor predeterminado: Indefinido.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará cuando se cierre el formulario con los siguientes parámetros:
<ResultadoCierre> – el valor transferido cuando se llama al método Cerrar del formulario abierto,
<ParámetrosAdicionales> – el valor especificado cuando se crea el objeto CallbackDescription.
Si no se especifica el parámetro, no se llamará ningún procedimiento después de la finalización.
Para su uso solo en modo de aplicación administrada.

Tipo: FormWindowOpeningMode.
Define el modo de apertura de ventana de un formulario de aplicación cliente.
Aplicable solo para aplicaciones administradas.

Un formulario abierto en el modo LockOwnerWindow no participa en la búsqueda de formularios abiertos. Si intenta abrir el mismo formulario (con el parámetro de unicidad establecido en Falso), no se encontrará el formulario abierto en este modo y se abrirá un nuevo formulario.
Valor predeterminado: Indefinido.

Descripción de la variante del método:

Abre un formulario por nombre. En este caso, se transmiten el nombre del formulario, los parámetros, el propietario, la clave de unicidad y la ventana donde se debe abrir a los parámetros.

Variante de sintaxis: Por formulario

Sintaxis:

OpenForm(<Formulario>, <Ventana>)

Parámetros:

Tipo: Formulario, FormularioAplicaciónCliente.
Un formulario o un formulario de aplicación cliente. En los clientes ligero y web, solo son aplicables los formularios de aplicación cliente.

Tipo: VentanaAplicaciónCliente.
La ventana de la aplicación en la que se abre el formulario.
Aplicable solo para un formulario de aplicación cliente. Solo se puede establecer una ventana de aplicación principal o una ventana de formulario auxiliar como ventana.

Valor devuelto:

Tipo: Formulario, FormularioAplicaciónCliente.

Descripción:

Abre y devuelve un formulario o un formulario administrado. Abre y devuelve solo un formulario administrado en cliente ligero y cliente web. Antes de abrir el formulario, busca un formulario idéntico ya abierto. La búsqueda se realiza por el tipo de formulario, los valores de parámetros clave del formulario, el propietario del formulario, la clave de unicidad del usuario.
Puede abrir un formulario ya obtenido. En este caso, se transmiten el formulario ya obtenido y la ventana donde se debe abrir a los parámetros.
Puede abrir un formulario por nombre. En este caso, se transmiten el nombre del formulario, los parámetros, el propietario, la clave de unicidad y la ventana donde se debe abrir a los parámetros.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).
La llamada al método ejecuta una llamada al servidor.

Nota:

Los parámetros de llamada son similares a ObtenerFormulario para la variante “Por nombre”.
No se admiten formularios ordinarios de procesadores de datos externos.
En la aplicación administrada, no se debe realizar la apertura y cierre programados del mismo formulario en una llamada de script.
Si no se especifica un nombre estándar en el parámetro <NombreFormulario> al abrir un formulario ordinario, se ignoran los parámetros transmitidos.
Durante la ejecución puede haber varias llamadas al servidor. Parte de ellas se almacena en caché. Siempre hay al menos una llamada al servidor y no se almacena en caché. El almacenamiento en caché depende de la versión de la plataforma y de la versión de la configuración en su conjunto. Si se establece una velocidad de conexión baja y no se indica la fila actual, entonces el formulario de selección se almacena en caché. La limpieza de la caché se realiza a intervalos de 20 minutos. Los formularios que no se hayan utilizado durante este período de tiempo se eliminan.

Véase también:

Contexto global, método ObtenerFormulario
Contexto global, método ObtenerFormularioComún
Contexto global, método AbrirFormularioModal

Disponible desde:

Disponible desde la versión 8.2.

---